home *** CD-ROM | disk | FTP | other *** search
/ Libris Britannia 4 / science library(b).zip / science library(b) / PROGRAMM / DB_CLIPP / 1984.ZIP / EZWIN.ZIP / EZHELP.TXT < prev    next >
Text File  |  1989-08-16  |  20KB  |  529 lines
  1.  
  2.      EZWIN Version 1.2
  3.  
  4.  
  5.  
  6.                 
  7.                               E Z W I N         
  8.                                                 
  9.                              Version 1.2
  10.                                                 
  11.                         (C) 1989 by Paul Jordan 
  12.                 
  13.      
  14.      EZWIN is a shareware product.  You may feel free to make copies,
  15.      and pass them on to friends for their evaluation.  If you make
  16.      use of this software, you are expected to pay a registration fee
  17.      of $20 to:
  18.          
  19.                                Paul Jordan
  20.                       909 Marina Village Parkway (#112)
  21.                              Alameda, CA 94501
  22.      
  23.      
  24.      *====================================================================*
  25.                                   OVERVIEW
  26.      *====================================================================*
  27.      
  28.      EZWIN is a Window Generator for dBASEIII and dBASEIII clones.
  29.      
  30.      Most Window Generators, or procedures,  I have seen are too
  31.      complicated, too cumbersome, or too expensive.  EZWIN was
  32.      designed to be intuitive, easy, and fast.  The Windows generated
  33.      can be called by, or merged into, any dBASEIII or dBASEIII clone
  34.      program you create.
  35.      
  36.      The 7 files that make up EZWIN are:
  37.      EZWIN.BAT, EZMAIN.EXE, EZWIN.DBF, EZCLEAN.BAT, DBFAST.EXE,
  38.      DBCLEAR.EXE and this help file, EZHELP.TXT
  39.      
  40.      EZWIN can be operated from the distribution diskette or copied to
  41.      its own directory on your hard drive.  To save typing path names, I
  42.      keep the EZWIN files in my dBASE directory.  This allows running
  43.      EZWIN directly from the dot prompt, and seeing the results immediately.
  44.      In either case, as with all programs, it is prudent to make a backup
  45.      copy of the distribution diskette before doing anything else.
  46.      
  47.      The instructions on the help screens included within the program
  48.      should get you started.  As a matter of fact, I suggest you start
  49.      EZWIN and 'play around' with it for awhile before reading any
  50.      further. Just type: EZWIN.
  51.      
  52.      *====================================================================*
  53.                             MAIN MENU COMMANDS
  54.      *====================================================================*
  55.      
  56.      The main menu contains the following options:
  57.      
  58.      (H)elp (N)ew (E)dit (D)isplay (M)ove (C)lear (A)lter (S)ave
  59.      (L)oad (Q)uit 
  60.      
  61.      Detailed Instructions on each Menu Option follows:
  62.  
  63.  
  64.  
  65.                                        -1-
  66.  
  67.  
  68.      EZWIN Version 1.2
  69.  
  70.  
  71.  
  72.      
  73.      (H)elp  -  Help presents instructions for each major menu
  74.      section.
  75.      
  76.      (N)ew  -  New is the first option you will use.  It creates your
  77.      Window.  Windows are used to display instructions, warnings and
  78.      menus. A window, should be smaller than your overall screen.     
  79.      How small, or large, is up to you.  Experimentation is the key.  
  80.      When you press (N)ew, a numbered inverse video line will be
  81.      displayed on the screen.  Start typing your text. Anything will
  82.      do for a sample.  When you have typed a few words, press <ENTER>
  83.      and start your next line.  When you are finished, Type the '@'
  84.      symbol on the next blank line. It is located on the upper half of
  85.      the number 2 key.  To type it, hold down your shift key, and
  86.      press the number 2. This signals EZWIN that you are finished with
  87.      the text part of your window and exits (N)ew.
  88.      
  89.      EZWIN determines the width of your window by the longest line you
  90.      typed, and the length by the amount of lines.  When you exit
  91.      (N)ew by typing the '@' symbol on a blank line, the window is
  92.      generated and automatically displayed in the center of the
  93.      screen. The default colors are Black Text on a White background. 
  94.      The colors, and position of the screen can be changed quickly and
  95.      easily.  
  96.      
  97.      (E)dit -  This feature is a simple Line-Editor, that allows you
  98.      to correct mistakes, and center lines of text within your window. 
  99.      When you first enter the editor, you are in TYPEOVER mode, which
  100.      means that anything you type, will overwrite what is on the
  101.      screen.  To enter the INSERT mode, press the Insert Key (Ins) on
  102.      your keyboard. In insert mode, anything you type (including
  103.      spaces), will push whatever is on the line to the right.
  104.      REMEMBER, that this is a line editor, and if you push characters
  105.      off the edge of the  window, they are gone.  Not to worry though,
  106.      EZWIN is so simple to operate, you can just re-edit and fix any
  107.      minor goofs. If you really get into a bind and want to add more
  108.      words than will fit, simply recreate the window.
  109.      
  110.      (D)isplay - The display option  will display, or re-display the
  111.      window after clearing the screen, or repositioning
  112.      (moving).
  113.      
  114.      (M)ove -  is one of the options that make EZWIN a delight to use. 
  115.      How many times have you created a window by typing in all those
  116.      nasty little @..SAY statements, and then decided that you didn't
  117.      like the position it is in.  With EZWIN you can re-load your
  118.      window and (M)ove it wherever you want.  EZWIN will take care of
  119.      re-writing the @..SAY statements.  
  120.      
  121.      To (M)ove your window, use the Up, Down, Left, and Right Arrow   
  122.      Keys. As the window moves, it will leave the original window     
  123.      position displayed on the screen. This provides you with an aid
  124.      to line up, or overlap other windows in a series, such as in
  125.      several 'instruction' windows.  As you become experienced with
  126.      EZWIN you will appreciate this feature.  When you are want to
  127.      clean up the screen, simply press (C)lear and everything around
  128.  
  129.  
  130.  
  131.                                        -2-
  132.  
  133.  
  134.      EZWIN Version 1.2
  135.  
  136.  
  137.  
  138.      the window will disappear.  When you have the window positioned  
  139.      where you like it, Press (Q)uit and you will be returned to the  
  140.      Main Menu. 
  141.      
  142.      (C)lear - clears the working area of the screen.
  143.      
  144.      *====================================================================*
  145.                               ALTER MENU
  146.      *====================================================================*
  147.      
  148.      (A)lter - is one of the key features of EZWIN.  It allows you to
  149.      Alter (change), the border style, and colors of your text and
  150.      background.
  151.      
  152.                The options on the (A)lter menu are:
  153.      
  154.                (H)elp - a quick on line help menu
  155.      
  156.                (S)tyle of Border - allows you to change the border
  157.                style. For no border press 0, for a singleline border
  158.                press 1, and for a doubleline border press 2.  Try them
  159.                all, and when your are finished press (Q)uit to return
  160.                to the ALTER menu.
  161.      
  162.                (T)ext -  This option allows you to change the color of
  163.                the Text in your window. Just press the letter (or
  164.                number) of the color you want. What you see is what
  165.                you get!. For those of you with Color Cards and
  166.                Monitors, the combinations are endless. If you have a  
  167.                Monochrome system, your choices will be limited.       
  168.                However, by utilizing regular and High Intensity White, 
  169.                you will be able to produce a variety of Window        
  170.                designs.
  171.      
  172.                (B)ackground - allows you to change the background
  173.                color of your window.  The menu is similar to the text
  174.                menu, except the color yellow is not represented.  DOS
  175.                presents yellow as a RED when used as a background
  176.                color, and is therefore not used.
  177.      
  178.      *====================================================================*
  179.                                     SAVE
  180.      *====================================================================*
  181.      
  182.      (S)ave -  When you press (S)ave, EZWIN asks if you would like to
  183.      add Menu Choices.  If you answer (Y)es, EZWIN will ask you to
  184.      type in the numbers (or letters) you will use for Menu Choices. 
  185.      When EZWIN generates your program it will generate an INKEY()
  186.      routine, fully error-trapped, to allow only your choices to pass.
  187.      Then all you have to do is write your IF..THEN, or DO CASE
  188.      statements to branch to other segments of your program.
  189.      
  190.      If you answer (N) to Menu Choices, EZWIN will ask if you would
  191.      like a Pause generated.  A Pause is useful when you are
  192.      presenting a series of Windows, and want the user to 'Press
  193.      AnyKey' to move on to the next one.  If you answer (Y)es, EZWIN
  194.  
  195.  
  196.  
  197.                                        -3-
  198.  
  199.  
  200.      EZWIN Version 1.2
  201.  
  202.  
  203.  
  204.      will generate an INKEY() statement that will allow the pressing
  205.      of any key to continue in your final window.
  206.      
  207.      If you do not want Menu Choices, or a Pause, EZWIN will just
  208.      generate a plain vanilla window, and it is up to your program to
  209.      decide what to do next.
  210.      
  211.      EZWIN will then ask you for the filename you wish to save your
  212.      window under. Simply type a standard DOS filename (up to eight
  213.      characters) and press <ENTER>. You can also type in a question
  214.      mark (?) to list the directory of window files already on disk,
  215.      or just press <ENTER> to quit. EZWIN will warn you if you try to
  216.      save a filename that is already on disk and present you with the
  217.      following options:
  218.      
  219.                (O)verwrite -  Overwrites (erases) the old file with
  220.                the same name.     
  221.       
  222.                (L)ist the Directory to see what other windows are
  223.                present. This gives you the chance to rename your file.
  224.      
  225.                (Q)uit -   to return to the Main Menu.
  226.      
  227.      
  228.      (L)oad -  EZWIN allows you to re-load any window files you have
  229.      already saved. This will allow you to change the borders,
  230.      colors, or move your window to a new position
  231.      
  232.      (Q)uit - From the Main Menu Returns you to DOS. From other menus,
  233.      you are returned to the previous menu.
  234.      
  235.      *====================================================================*
  236.                                  DESIGN TIP
  237.      *====================================================================*
  238.      
  239.      If you wish to present several windows on the screen at the same
  240.      time, you can see what the final lay-out will look like by doing
  241.      the following.  As you work on your first Window, move it to the
  242.      location desired and save it as A1.  Now create your second
  243.      window, move it and save it as A2 or whatever.  Do the same with
  244.      your third window, etc...etc...
  245.      
  246.      To see what they will look on the same screen, simply (L)oad them
  247.      back in the same order.  Then, if you are not satisfied with   
  248.      the screen layout, load back the offending Window and     
  249.      reposition it.
  250.      
  251.      *====================================================================*
  252.                  HOW TO USE THE WINDOWS IN YOUR PROGRAMS
  253.      *====================================================================*
  254.      
  255.      There are 3 ways to use Windows in your programs.
  256.      
  257.      1.  Leave your Window programs exactly as generated. Then, call
  258.      them, as you would any dBASE program, by issuing a DO command.
  259.      Until you are satisfied with the exact wording, and location of
  260.  
  261.  
  262.  
  263.                                        -4-
  264.  
  265.  
  266.      EZWIN Version 1.2
  267.  
  268.  
  269.  
  270.      your windows, this is the suggested method. 
  271.      
  272.      2. Using your text editor 'Merge' them into your program where
  273.      you want them.
  274.      
  275.      3. Use them in PROCEDURE files.  If you choose this method, you
  276.      must add the line: PROCEDURE FileName - (where FileName is the
  277.      name of your window) as the first line of the window.  Once
  278.      again, call it as you would any dBASE procedure with a DO
  279.      FileName.
  280.      
  281.      
  282.      *====================================================================*
  283.                              TECHNICAL STUFF
  284.      *====================================================================*
  285.      
  286.      EZWIN was compiled using the dbFAST compiler. The batch file EZWIN.BAT
  287.      loads the compiler engine DBFAST, runs the program EZMAIN.EXE, and then
  288.      unloads the compiler from memory returning the space used to your computer.
  289.      
  290.      EZWIN saves three files for each window with the extensions .PRG,
  291.      .WIN, and .EZM. The .PRG file is the actual window you will
  292.      use.  The .WIN (database) and .EZM (memory) files are working files,
  293.      and provided to allow you to re-load your windows for further work.
  294.      You do not need them in order to use the .PRG files. The .WIN file
  295.      holds the textlines of the window you created, and the .EZM file holds
  296.      the window coordinates and other variables needed for re-loading your
  297.      window.
  298.      
  299.      When you are satisfied with your windows, the .WIN and .EZM files
  300.      can be erased from your disk.  EZCLEAN.BAT is included on the
  301.      distribution disk to allow you to do this quickly and
  302.      easily. Simply type: EZCLEAN, and away they go to computer
  303.      heaven.
  304.      
  305.      The EZWIN.DBF is needed by EZWIN to hold the textlines.  If you accidently
  306.      trash it, the structure can be recreated using the CREATE command of
  307.      dBASEIII or the clone version you are using.  It consists of 1 character
  308.      field named TEXTLINE, with a length of 79 and should be empty.
  309.      
  310.      Structure for database: C:ezwin.dbf
  311.      Number of data records:       0            
  312.      Date of last update   : 08/13/89           
  313.      Field  Field Name  Type       Width    Dec 
  314.          1  TEXTLINE    Character     79        
  315.      ** Total **                      80        
  316.                                                 
  317.      
  318.      
  319.      *====================================================================*
  320.           WHAT THE EZWIN GENERATED WINDOW PROGRAM FILE LOOKS LIKE
  321.      *====================================================================*
  322.      
  323.      The program (.PRG) file generated by EZWIN, looks like this:
  324.      
  325.      * TEST.PRG generated by EZWIN (C)opywrite 1989 by Paul Jordan    
  326.  
  327.  
  328.  
  329.                                        -5-
  330.  
  331.  
  332.      EZWIN Version 1.2
  333.  
  334.  
  335.  
  336.      
  337.      SET COLOR TO N/W 
  338.      @ 9, 24 CLEAR TO 13, 54 
  339.      @ 9, 24 TO 13, 54 DOUBLE 
  340.      @ 10, 26 SAY "This is a Sample Program" 
  341.      @ 11, 26 SAY "file created with the EZWIN" 
  342.      @ 12, 26 SAY "Program.   <Press AnyKey>" 
  343.      SET COLOR TO W/N  
  344.       
  345.      * EOF TEST.PRG
  346.      
  347.      
  348.      NOTE: The last line of an EZWIN generated window always resets
  349.      colors to White Text on a Black background. This is so the EZWIN
  350.      colors do not get passed to your program.  If you do NOT want
  351.      White Text on a Black background, you must add a line with the
  352.      colors of your choice.
  353.      
  354.      *====================================================================*
  355.               USING THE MENUCHOICE ROUTINE WHEN CREATING MENUS
  356.      *====================================================================*
  357.      
  358.      An EZWIN window program used as a menu, and generated with Menu
  359.      Choices selected from the (S)ave option, looks like the following:
  360.      
  361.      * SAMPLE.PRG generated by EZWIN (C)opywrite 1989 by Paul Jordan  
  362.       
  363.      SET COLOR TO N/W 
  364.      @ 6, 23 CLEAR TO 16, 55 
  365.      @ 6, 23 TO 16, 55 DOUBLE 
  366.      @ 7, 25 SAY "===== SAMPLE EZWIN MENU =====" 
  367.      @ 8, 25 SAY "" 
  368.      @ 9, 25 SAY  "    1. Add New Records"
  369.      @ 10, 25 SAY "    2. Find/Edit Records" 
  370.      @ 11, 25 SAY "    3. Print Invoices" 
  371.      @ 12, 25 SAY "    4. H E L P ?" 
  372.      @ 13, 25 SAY "    5. Quit to DOS" 
  373.      @ 14, 25 SAY "" 
  374.      @ 15, 25 SAY "        Press (1-5)" 
  375.      SET COLOR TO W/N  
  376.       
  377.      keychoice = ' ' 
  378.      DO WHILE .NOT. keychoice $"12345" 
  379.         keypress = INKEY() 
  380.         keychoice = UPPER(CHR(keypress))
  381.      ENDDO 
  382.       
  383.      The characters after the $ sign in the Quotes, are those
  384.      added using the MenuChoice feature. The program will only
  385.      continue if the user presses one of those keys.  It is up to
  386.      you to write your own IF..THEN or DO CASE statement to tell
  387.      your program what to do next. To use your menu Window simply
  388.      call it with a DO statement, and then write your CASE
  389.      selections.  For example:
  390.      
  391.           DO test
  392.  
  393.  
  394.  
  395.                                        -6-
  396.  
  397.  
  398.      EZWIN Version 1.2
  399.  
  400.  
  401.  
  402.           DO CASE
  403.              CASE keychoice = "1"
  404.                   DO procedure1
  405.              CASE keychoice = "2"
  406.                   DO procedure2
  407.              CASE keychoice = "A"
  408.                   Do procedureA
  409.                   etc...
  410.                   (Add additional CASE statements as needed)
  411.           ENDCASE
  412.      
  413.      If you decide to use the MenuChoice or Pause feature in EZWIN,
  414.      remember to SET TALK OFF and declare the variable 'keychoice'
  415.      public in your main program as follows:
  416.      
  417.           SET TALK OFF
  418.           PUBLIC keychoice
  419.      
  420.      *====================================================================*
  421.                         USING EZWIN's PAUSE FEATURE
  422.      *====================================================================*
  423.      
  424.      If you choose PAUSE when saving your EZWIN window, a simple
  425.      inkeys routine is generated at the end of your window,
  426.      which looks like this:
  427.       
  428.      keypress = 0              
  429.      DO WHILE keypress = 0     
  430.         keypress = INKEY()     
  431.      ENDDO                     
  432.       
  433.      Any Key pressed will cause the program to continue.
  434.      
  435.      
  436.      *====================================================================*
  437.                                FUTURE GOODIES
  438.      *====================================================================*
  439.      
  440.      Plans for the next version of EZWIN include:
  441.      
  442.          - Double Borders, with option to change Border Colors
  443.          - Neat looking Drop Shadows, for that 'professional' look
  444.            using the colors of your choice
  445.          - Expansion Feature to enlarge windows (or reduce them)
  446.          - Case Statement Generator which will allow EZWIN to be used
  447.            as a full-blown menu generator. (You won't have to write your
  448.            own CASE statements)
  449.          - Any other improvements suggested by users
  450.      
  451.      That's All Folks! I hope you enjoy using EZWIN, and I urge you to
  452.      pass copies to your friends, associates, and favorite Bulletin
  453.      Boards. EZWIN is not a free program, and if you make use of it,
  454.      you are expected to send in your registration fee of $20.
  455.      
  456.                                 Thank you.
  457.                                 Paul Jordan
  458.  
  459.  
  460.  
  461.                                        -7-
  462.  
  463.  
  464.      EZWIN Version 1.2
  465.  
  466.  
  467.  
  468.           
  469.      
  470.      ----------------------------------------------------------------
  471.      
  472.                             I N V O I C E
  473.      
  474.      Remit to:  Paul Jordan
  475.                 909 Marina Village Parkway, (#112)
  476.                 Alameda, CA 94501
  477.      
  478.      From:      __________________________________
  479.                 __________________________________
  480.                 __________________________________
  481.                 __________________________________
  482.                 __________________________________
  483.      
  484.      Contact:   __________________________________
  485.                 __________________________________
  486.      
  487.      
  488.      QTY                                          UNIT PRICE   TOTAL
  489.      
  490.      _____      EZWIN Window Generator Vers 1.2     $20        ______
  491.      
  492.      Note that EZWIN Software has been delivered and accepted by customer.
  493.      
  494.      --------------------------------------------------------------------
  495.       
  496.      
  497.      
  498.      
  499.      
  500.      
  501.      
  502.      
  503.      
  504.      
  505.      
  506.      
  507.      
  508.      
  509.      
  510.      
  511.      
  512.      
  513.      
  514.      
  515.      
  516.      
  517.      
  518.      
  519.      
  520.      
  521.      
  522.      
  523.      
  524.  
  525.  
  526.  
  527.                                        -8-
  528.  
  529.